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Ablage von Pro jektinf ormationen in XML 

Die Ablage von Pro j ektdaten einer Automatisierungskomponente 
erfolgt in XML. Dabei werden die Daten entweder direkt in 
5 diesem Format abgelegt Oder entsprechende Export/ Import Funk- 
tionen bereitgestellt um Pro j ektdaten nach aufien im XML For- 
mat bereitzustellen . 

Durch dieses Vorgehen werden sind die Projektdaten auiJerhalb 
des Projekts in einem standardisierten Datenformat verfiigbar. 
10 Auf dieser Basis konnen externe Werkzeuge fur die vollstandi- 
ge oder teilweise weitere Verwertung oder Erzeugung von Pro- 
j ektdaten eingebunden werden. 

Beispiele fur solche externe Werkzeuge sind: 
15 - Versionsverwaltungstools wie ClearCase oder PVCS 
Externe CAD-Programme 
Externe Kurvenscheibenwerkzeuge 

Externe Productivity Tools die Teile von Projektdaten ge- 
nerieren konnen 

20 - Externe Skripting Mechanismen um die Erzeugung oder Dupli- 
zierung von Projektdaten zu unterstutzen 

Durch die Nutzung des Standardf ormats konnen kommerzielle 
Werkzeuge, die auf XML abbilden, genutzt werden. 
(^5 Dartiberhinaus konnen extern erzeugte auf XML basierenden Da- 
ten wie z.B. Maschinenbilder in das Projekt importiert wer- 
den. 

Auf Basis der genannten Mechanismen konnen z.B. Anderungen 
30 von Projekten durch Vergleich der Projektdaten im XML-Format 
sehr einfach erkannt und Unterschiede f einstgranular aufbe- 
reitet werden. Dies ist insbesondere fur FDA und dem hiermit 
notwendigen Change Control wichtig . 

35 
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XSLT Standard (http://www.w3.org) 




Visualisierung 
(HTML) 



Dokumentation 
( FrameMaker ) 
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Einlei tung 

Der Entwicklungsname von SIMOTION war UMC (Universal Motion 
Control) . Es stellt ein Basisautomatisierungssystem dar. Mit 
5 dieser Software ist es moglich durchgangige Automatisierungs- 
systeme fur Produktionsmaschinen zu erstellen (z.B. fur Ver- 
packungsmaschinen, Textilmaschinen, Pressen oder Kunststoff- 
maschinen) . Die Anf orderungen fiir die SIMOTION- Software ba- 
sieren auf Erfahrungen mit anderen SIEMENS A&D - Produkten 
10 wie zum Beispiel SINUMERIK. Diese und andere Produkte des Be- 
reiches A&D erfullen schon heute die Anf orderungen an das Au- 
^ tomatisierungssystem. Aber die Gesamtlosung ist unzureichend 
und oft nicht wettbewerbsf ahig, was sich mit der SIMOTION- 
Software andern soli, Deswegen ist die Zielsetzung des 
15 SIMOTION, eine optimale Systemplattf orm fiir Automatisierungs- 
losungen zu bieten. AuBerdem soil SIMOTION die Moglichkeit 
bieten, Maschinenablauf e (SPS), spezifische Technologief unk- 
tionen und vor allem Motion Control - Funktionen zu program- 
mieren . 

20 

SIMOTION ist prinzipiell aus zwei Teilen aufgebaut. 

Das Runtime system von SIMOTION, das zu Entwicklungszeiten 
IMC- RT hieli, ist auf drei verschiedenen Zielsystemen lauffa- 
5 hig: 

- Drive-based, 

- SPS-based und 

- PC-based. 

Es beinhaltet grundsatzlich ein Betriebssystem, Schnittstel- 
30 len zum Antrieb, Basisf unktionen ( wie Lageregler, Interpola- 
tor, Positionieren, Ref erenzieren, SPS-Funktionalitat ) und 
aufierdem Treiber fur den Feldbus PROFIBUS DP. Die Kommunika- 
tion des Gesamtsystems ist liber eine Standardkommunikation 
mit SIMATIC, PC und OVA gewahrleistet . 
35 Technologiefunktionen konnen mit Hilfe von Firmwarekomponen- 
ten hinzugeladen werden. Das Konf igurieren dieser Funktiona- 
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litat wird auf einem Erstellsystem vorgenommen und durch ei- 
nen Ladevorgang in das Zielsystem ubertragen. 

Das SIMOTION SCOUT hieii wahrend der Entwicklung UMC- ES, was 
Erstell- bzw. Engineeringsystem bedeutete. 

Es kann als eigenstandiges System oder als System, das auf 
Step7 aufsetzt, genutzt werden. 

Das SIMOTION SCOUT enthalt eine Vielzahl von Funktionalitat : 

• Es ist moglich ein System oder eine Komponente zu konfigu- 
rieren, zu programmieren und zu pro j ektieren . 

• Programmiertools fur das Runtimesystem sind im SIMOTION 
SCOUT enthalten. 

• Der Test und die Inbetriebnahme, sowie die Diagnose- und 
der Service kann durch die Software unterstutzt werden. 

• SIMOTION SCOUT ist mit einer Bibliotheksf unktion fur Pro- 
gramme, Konf iguration (HW-, SW-Konf iguration) und Maschi- 
nen ausgestattet . 

• SIMOTION SCOUT kommuniziert mit dem Basis ES, das die Da- 
tenhaltung steuert und fur den Zugriff auf die Daten zu- 
standig ist . 

• Aufierdem gibt es die Moglichkeit des Teleservice, der 
Ferndiagnose und der Ob j ektverwaltung . 
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Abb il dung 0.1: Das Universal Motion Control System 



Die SIMOTION- Software ist nach dem Three-Tier-Konzept aufge 
baut. Sie besitzt also eine grafische Oberflache, eine Verar 
beitungsschicht und eine Datenschicht • 
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Grundlagen 

Dieses Kapitel soil einen Einblick in die Grundlagen der 
Software geben. Auflerdem soli es alle im Export- Import- Me- 
chanismus verwendeten Begriffe und Techniken vermitteln. Es 
stellt aber keine vollstandige Dokumentation dar, deswegen 
verweise ich an geeigneter Stelle auf Ref erenzdokumente . 

(a) Was ist ein Snap- In? 

Allgemein versteht man unter einem Snap- In bei SIMOTION ein 
COM- Objekt. Die Workbench kann den Server in Form einer Dll 
laden und somit uber die Schnittstellen des Servers auf Funk- 
tionen des Snap- Ins zugreifen. Die Kommunikation geht von 
einem Snap- In Host in der Workbench aus . 

Neue Snap- Ins werden mit der Workbench installiert, konnen 
aber auch spater hinzugefugt werden. Ebenso konnen Snap- Ins 
wieder entfernt werden. Wenn ein neues Snap- In hinzugefugt 
wird, legt es einen Registry- Eintrag an. Beim Starten der 
Workbench wird die Registry durchsucht. Neue Snap- Ins in- 
stalliert die Workbench automatisch. Durch diesen Aufbau ist 
es moglich durch neue Snap- Ins dynamisch Funktionalitat zu 
dem SIMOTION SCOUT hinzuzufugen und gegebenenf alls zu entfer- 
nen. Snap- Ins werden jedoch nicht sofort beim Start der 
Workbench geladen. Dies geschieht erst wenn eine Benutzterak- 
tion ein Snap- In anspricht. Das Benutzterkommando wird von 
der Workbench an das entsprechende Snap- In weitergeleitet . 



Benutzeraktion 



UMC- Workbench 




UMC- Workbench 



a 



^ Snap in 
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Beim Laden eines Snap- Ins kann die Oberflache sowie die Me- 
mistruktur von SIMOTION SCOUT geandert werden. Es ist mog- 
lich, dass Toolbars eingefiigt werden und verschiedene Pro- 
jektteile eine neue Darstellung erhalten. 

Ein Snap- In mufi bei SIMOTION bestimmten Anf orderungen genii- 
gen : 

- Da es ein COM- Objekt im herkommlichen Sinne ist, mufl die 
IUnknown- Schnittstelle implementiert sein, wie COM es 
vorschreibt . 

- Fur die Kommunikation zwischen der Workbench und dem Snap- 
In muJJ die Schnittstelle IUMCSnapIn vorhanden sein. 

- Auflerdem mussen alle Snap- Ins unter der Kategorie ^Snap- 
In of UMC-Workbench" in der Registry eingetragen sein. 

Wenn diese Anf orderungen erfullt sind, konnen noch optional 
neue Schnittstellen hinzugefugt werden. Diese Schnittstellen 
eignen sich, um spezielle Aufgaben zu ubernehmen wie zum Bei- 
spiel Dateiverwaltung, Kommunikation mit anderen Snap- Ins 
Oder grafische Schnittstellen. 
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IUnknown fej 
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optionales Interface 













Abbildung 0.2. : Schnittstellen eines Snap- Ins 

(b) Anforderungen und Vorteile des Export- Import- Tools 

Durch die Export- Import- Software soil es ermoglicht werden, 
dass die Daten eines SIMOTION- Projektes aus dem Basis ES in 
ein lesbares ASCII- Format exportiert werden konnen. Mit Hil- 
fe dieser exportierter Daten soil durch die Import- Funktion 
ein lauffahiges Projekt erzeugt werden konnen. 

Die exportierten Daten werden im XML- Format gespeichert. Da- 
bei wird unter den Teilkomponenten eines Projektes unter- 
schieden, indem sie in verschiedenen XML- Dateien beschrieben 
werden. Die bei dem Export entstandenen Dateien liegen in ei- 
ner Verzeichnisstruktur vor, die an den Aufbau des SIMOTION- 
Projektes angelehnt ist. An die Export- Import- Software des 
SIMOTION SCOUT werden folgende Anforderungen gestellt: 

- Die entstandenen Dateien sollen die Projektdaten mit Hilfe 
einer XSL- Datei in einer geordneten, tabellarischen Form 
im Internet- Explorer 5 anzeigen. 

- Exportierte XML- Dateien sollen bei der Diagnose eines 
Projektes hilfreich sein. Dies wird durch die Navigation 
liber das Projekt im Internet- Explorer erreicht. 
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- Weiterhin sollen durch einen modularen Aufbau des expor- 
tierten Projektes einzelne Teilkomponenten eines Projektes 
komf ortabel ausgetauscht und unabhangig von der Version 
der SIMOTION- Software in andere Projekte eingefiigt werden 
konnen . 

- Durch einen strukturierten Aufbau der Dateien im Verzeich- 
nisbaum, soil die Archivierung und Erstellung von Versio- 
nen eines SIMOTION- Projektes vereinfacht werden. 

- Aufierdem kann man Dateien liber das Internet, per Email o- 
der liber FAX an dritte weiter zu geben . 

- Es ist prinzipiell moglich, dass der Benutzter mit Hilfe 
eines ASCII- Editor Daten des Projektes andern kann und 
diese durch den Import in das Projekt ubernehmen kann. Wo- 
bei die Anderung von Projektdaten normalerweise im Projekt 
in der Workbench vorgenommen werden sollte. 

(c) Einordnung des Exports und des Imports in die SIMOTION- Software 

Das in der Einleitung genannte Three-Tier-Konzept kommt auch 
in der Import- Export- Software zur Anwendung. 
Die grafische Benutzteroberf lache wird in der Workbench liber 
ein Snap- In angeboten. 

Die gesamte Verarbeitung des Ex- oder Imports wird durch den 
XML- Server realisiert. Er kann uber Schnittstellen auf die 
Daten des Basis ES lesend oder schreibend zugreifen. Uber ei- 
nen sogenannten Connection-Point werden die Ausgaben bei dem 
Export oder Import an das Snap- In in der Workbench gegeben. 
Die Daten werden mit Hilfe eines XML- Parser ubersetzt. Bei 
dem Export ist die Datenschicht das Basis ES, aus dem die Da- 
ten der XML- Files gewonnen werden. Bei dem Import ist dies 
umgekehrt. Die XML- Dateien werden ausgelesen und die Daten 
in das Basis ES geschrieben. 
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Workbench 




Abbildung O.3.: Kommunikation des Export- Import- Tools 



(d) Das XML- Format 



XML (extensible Markup Language) ist eine Metasprache fur das 
Definieren von Dokumenttypen . Es ist damit moglich, Dokumente 
zu erstellen, die alle den gleichen Grundmustern im Aufbau 
folgen. Auf der Grundlage dieser Dokumente konnen Programme 
leichter arbeiten . 
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Andere Vorteile von XML sind, dass die Daten strukturiert und 
hierarchisch beschrieben werden konnen. Aufierdem ist die 
Sprache Plattform unabhangig und einfach von Mensch und Ma- 
schine zu erzeugen. Ein entscheidender Aspekt fur die Verwen- 
dung von XML ist, dass eine strickte Trennung zwischen In- 
halt, Darstellung und Struktur vorgenoramen wird. 
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XML 

Darstellung 
XSL-Datei 
(Style-Sheets) 




Abbildung 0.4. : Aufbau und Gliederung von XML 

(e) Unterschiede zwischen XML und HTML 

5 Warum die meisten Anbieter, Programmierer und Anwender von 
9 HTML auf XML umsteigen ist sehr einfach zu erklaren. Wahrend 
HTML eine Auszeichnungssprache ist, ist es mit XML moglich 
eine Auszeichnungssprache zu definieren. 

Vorteilhaft ist auch das Definieren eigener Tags. XML- Files 
10 konnen ganz bestimmte Tags enthalten und diese konnen wieder- 
um Tags enthalten. Dadurch kann ein XML- File einen Baum auf- 
bauen, der zu einer strukturierten Trennung verschiedener In- 
halte ftihrt. Damit ist die Grundlage fUr eine maschinelle Be- 
arbeitung des Dokumentes gewahrleistet , die mit einem HTML- 
15 Dokument leider nicht gegeben ist. Ein groBer Unterschied 

zwischen HTML und XML ist die Trennung von Inhalt, Darstel- 
lung und Struktur. Nachteilig erscheint manchen Programmie- 
rer, dass er bei HTML sehr frei in seiner Formulierung ist, 
™ wahrend er bei XML auf die Wohlgef ormtheit eines Dokumentes 
20 achten mufi (siehe Kapitel (f ) ) . 

(f) Gultigkeit, Wohlgeformtheit, validierende und nicht-validierende Parser 



Bei der Verarbeitung von XML- Dokumenten, wird zwischen zwei 
Instanzen unterschieden: dem XML- Parser und der Anwendung. 
25 Der Parser verrichtet seine Arbeit im Sinne einer Anwendung 
und ist in den meisten Fallen ein Browser. Es kann mit zwei 
verschiedenen Parsern gearbeitet werden, mit dem DOM- oder 
dem SAX- Parser. Der DOM- Parser erstellt einen XML- Baum und 
der SAX- Parser ist ereignisorientiert . Diese beiden Parser 
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werden im Kapitel 0 naher erklart. Alle Parser sollten jedoch 
diese Eigenschaf ten erfullen: 

- Ein Parser priift ein XML- Dokument auf Wohlgef ormtheit und 
gibt gegebenenf alls Fehler aus. 

5 - Wenn das Dokument aus mehreren Bestandteilen aufgebaut 
ist, werden diese zusammen gefugt. 

- Auiierdem wird ein Baum erstellt, durch den die Anwendung 
auf die Inhalte der Tags zugreifen kann. 

10 Wenn ein Dokument auf Giiltigkeit untersucht wird, vergleicht 
der Parser das Dokument mit der DTD, Da dieser Vergleich sehr 
^ umf angreich ist, wurde das Konzept der Wohlgef ormtheit einge- 
fuhrt. Bei diesem Konzept wird lediglich sichergestellt , dass 
die Erstellung des Baumes moglich ist. 

15 

Grundsatzlich ist ein Dokument wohlgeformt, wenn es folgende 
sechs Eigenschaf ten besitzt: 

1. Jedes XML- Dokument mufi mit einer Deklaration beginnen. 
Wie zum Beispiel: <?XML version = *1.0* ?>. 
20 2. Alle Elemente mussen ein Ende- Tag besitzen: 

<title> Der Export - Import - Mechanismus des SIMOTION 
SCOUT </title> 

Ebenso mussen leere Elemente wie <BR> ein Ende- Tag besit- 
zen : 

£5 Entweder <BR/> oder <BR> </BR>. 

3. Alle Elemente sind case-sensitive, das heifi zwischen 
Grofl- und Kleinschreibung wird unterschieden . 

4. Alle Attributwerte sind in Hochkommas zu setzen. 

5. Ein sauberes Verschachteln der Tags ineinander mufl gewahr- 
30 leistet sein. Das heiBt untergeordnete Tags mussen ge- 

schlossen werden bevor ubergeordnete Tags geschlossen wer- 
den. 

6. Ein Element mufi als eine Art Container alle anderen Ele- 
mente einbetten. 

35 
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Da bei der Prtifung auf Wohlgef ormtheit kein Abgleich mit der 
DTD statt findet, ist ein wohlgef ormtes XML- Dokument nicht 
unbedingt gultig. 
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Abbildung 0.5.: Unterscheidung Wohlgefornrtheit und Giiltigkeit eines XML- Dokuments 



Aus diesen Grunden kommen zwei verschiedene Parser zur Anwen- 
5 dung, Ein validierender Parser priift auf Giiltigkeit, ein 
nicht validierender Parser priift auf Wohlgef ormtheit eines 
XML- Dokuments. Wenn auf die Giiltigkeit eines Dokumentes ge- 
priift wird, ist die Priifung auf Wohlgef ormtheit eingeschlos- 
sen • 

^fcb (g) Die Stylesheets (XSL) 

XSL (extensible Stylesheet Language) ist eine Beschreibungs- 
sprache der Darstellung eines XML- Dokumentes. Mit Hilfe ver- 
schiedener XSL- Dateien konnen XML- Dokumente andere Darstel- 

15 lungen annehmen. 

Bei HTML wird die Darstellung mit cascading Stylesheet Langu- 
age (CSS) beschrieben. Diese Beschreibungsart kann ebenso in 
XML- Dokumenten eingesetzt werden, jedoch gibt es bei XSL ei- 
nige Vorteile gegeniiber CSS. XSL ist eine Programmiersprache 

20 im herk.ommlichen Sinne, das heiBt IF- Abfragen und Speiche- 
rung von Werten in Variablen konnen gesetzt werden. Einzelne 
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Komponenten konnen genommen werden und an anderen Platzen 
auftauchen, wie zum Beispiel in der Kopf- oder Fufizeile. Da 
XSL nicht an die Sprachen der westlichen Welt angepasst ist 
und damit nicht ausschliefilich horizontale Schrif tzeichen 
dargestellt werden konnen, ist es global verwendbar. 
Damit ein XML- Dokument eine XSL- Datei zur Darstellung he- 
ranzieht, mufl diese am Anfang des XML- Dokumentes bekannt ge- 
macht werden. 
Zum Beispiel : 

<?xml-stylesheet type="text/xsl" href="umc.xsl"?> 

(h) Die Struktur einer XML- Seite (DTD) 

In einer DTD (Documenttype- Definition) wird die Struktur und 
die Gliederung eines XML- Dokumentes festgelegt. Alle in ei- 
nem XML- Dokument verwendeten Elemente mussen in der zugeho- 
rigen DTD beschrieben werden. Weiterhin mufi in der DTD fest- 
gelegt werden, wie die Elemente verschachtelt sind und welche 
Werte die Attribute annehmen konnen. 

Durch die Festlegung der Regeln fur XML- Dokumente in einer 
DTD, ist es moglich einer Anwendung das Auslesen und die Ver- 
arbeitung der Daten zu tiberlassen. 

DTD konnen in einer separaten Datei untergebracht werden (ex- 
terne DTD) . Anderenfalls kann die DTD am Anfang des XML- Do- 
kumentes stehen, wobei sie hier interne DTD genannt wird. 
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Ein Ordner besreht sus mindestens einem Buck 

<! ELEMENT ordner (book)+ > 

Der Ordner hat als Pflichattribut die iD 

< ! ATTL I ST ordner id ID #REQUIRED > 

Ein Buch hesitel etrien Titel. rritndftsteris emeu Autor und wurde durch emen Verlag verfrffentlicht 

<! ELEMENT book ( title, author*. puplisher )> 

< ! ATTL I ST book isbn CDATA #REQUIRED> 

Ein Titel besteht aus einem String 

< ! ELEMENT title ( #PCDATA )> 
<! ELEMENT author (#PCDATA)> 
< (ELEMENT publisher (#PCDATA)> 



Abbildung O.6.: Beispiel filr eine DTD 
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Das Snap- In in der Workbench 

Das Snap- In des XML- Tools ist ein mittels ATL geschriebener 
COM- Server, der eine Schnittstelle zwischen dem Benutzer und 
dem XML- Server darstellt. Durch bestimmte Benut zeraktionen 
kann das Snap- In geladen werden. Uber die grafische Oberfla- 
che kann der Benutzer den Export und den Import bedienen. Die 
Kommunikation zwischen Snap- In und Workbench wird uber ver- 
schiedene Schnittstellen des Snap- Ins ermoglicht. 

(i) Das GUI des Snap- Ins 

Dieses Kapitel beschreibt die grafische Oberflache, die das 
Snap- In zur VerfiAgung stellt, und dessen Bedienung zum Ex- 
oder Import von Pro j ektdaten . 

(j) Starten des Ex- oder Imports 

Das Snap- In wird beim Klicken auf den entsprechenden Button 
oder beim Auswahlen des Exports oder Imports im Menu „Datei* 
geladen. 
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Abbildung 0. 1.: Laden des Snap- Ins durch Benutzeraktionen 

(k) Der Export eines Projektes 



Der Export eines Projektes ist natiirlich nur moglich, wenn 
ein Projekt geoffnet ist. Nach dem des Exports wird das Snap- 
In geladen und es erscheint dieser Dialog: 
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Projekt Export 



m 



T Export Emslellungen * — . . „ „ , . 

1 Geben sie Ziefpfad unci Zielnamen des Exports ojv ^ ; 



pro.gr e m m e\S i em en s\Ste p AS 7p r o \\Pt o i e kt\u 7V>:m I d ale\Pro j e kt xir 



"■' | '"",'^ | '"'^ ( ^, , ,. „. ' , \ , l II... IHIMII-.^m!^!^!,,-, ] ,. ..I' 



Abbildung 0.2. : Der Exportdialog 




Der Projektpfad beschreibt das Verzeichnis, in dem die expor- 



5 tierten Daten gespeichert werden sollen. Man kann im Dialog 
einen Ordner angeben, der das exportierte Projekt beinhalten 
soli. Durch den „0rdner- Button* kann der Ordner aus dem Ver- 
zeichnisbaum ausgewahlt werden. 



jverzeichnis auswahfen 




; Wahlen 


Sie ein ZieJvsrzeicnms fiir den Export aus; 




B-Sfl Desktop 
ill B-M Arbeitsplatz 
M 3'£-Diskette(A:) 
£ j fk-^m (C:) 
ill: !•••& airtodbg 
11 j j :-©AKNFZZ 
If i AS Config 
If j j ® m MSOffice.97 
|j§f j i (2D mvfslogs 
I s j ErSl Programme 
"P : $-23 Adobe 

! lfr£2lJ Gemeinsame Dateien 
; i Internet Explorer 

„ j I \ Logitech 


Miii 

« 

Mill 
\zl, 




- - 

OK j. Abt 


>rechenj j 



1 0 Abbildung 0.3.: Wfihlen eines Verzeichnisses fur das zu exportierende Projekt 



Dabei ist zu beachten, dass alle im Ordner vorhandenen Datei- 
en zu Beginn des Exports geloscht werden. Mit dem OK- Button 
wird letztendlich der Export gestartet. 
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(I) Der Import eines Projektes 

Der Import hat zwei Moglichkeiten ein Projekt zu importieren. 
Zum Einem konnen die Daten in ein bestehendes Projekt einge- 
fUgt werden. Dazu muli der Import gestartet werden, wenn ein 
Projekt geoffnet ist. Der Benutzer wird vor dem Import ge- 
fragt, ob er das Projekt andern will. Wenn der Import in ein 
bestehendes Projekt durchgefiihrt wird, werden neue Daten ein- 
gefugt, Daten, die im zu importierenden Projekt sowie im be- 
stehenden Projekt vorkommen, durch die importierten Daten ak- 
tualisiert und bestehende Daten beibehalten. 

Zum Anderen kann beim Import ein neues Projekt angelegt wer- 
den. In diesem Fall muii der Import gestartet werden, wenn 
kein Projekt geoffnet ist. Das importierte Projekt ist nach 
dem Import mit dem exportierten Projekt identisch. 
Der Import blendet einen ahnlichen Dialog auf wie der Export. 
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1 Pro jekt Import E3 






: OrtderXMLProiaktD&leien: , 




\ a : Zielpfad und 2ieinome ; der Projektdaiei; = 








•: 


















Abbrechen ; \ 


Help ' | 









Abbildung 0.4.: Der Importdialog 

Der Zielpfad zeigt auf das neu angelegte Pro jekt oder auf das 
5 Projekt, in das importiert werden soil. Hier ist ebenfalls 
der Projektpfad angegeben, in dem das Projekt importiert 
wird. Es sollte in diesem Dialog eine XML- Datei ausgewahlt 
werden, die die Wurzel des zu importierenden Projektes ist. 
Diese XML- Datei kann durch einen File- Dialog ausgewahlt 
10 werden, der durch den „Ordner- Button* angezeigt wird. 



Wahlen sie das entsprechende XML-File axis: BB 




Abbildung 0.5.: Wahlen eincr XML- Datei fur den Import 

(m)Die Statusausgabe des Ex- bzw. Imports 

15 Der Status des Exports oder des Imports wird jeweils in einem 
Ausgabef enster dokumentiert . Dort wird der Benutzer auf Feh- 
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ler, die rot hervorgehoben sind, aufmerksam gemacht, die Be- 
endigung des Exports oder Imports ausgegeben und ein Link zu 
den XML- Dateien anzeigt. 
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UMC - uqwusqwoQ 




Der Export der Projektdaten wurde gestartet 
BitteWarten... 

Einstiegspunkt fur das Betrachten der Daten im Internet Explorer (Version 5): 

Ort der exportierten XML-Oaten: 
D:\test1\ 

Der Export der Projektdaten wurde beendet 



Abbildung 0.6. : Statu saus gab e des Ex- oder Imports 



mm 



10 



Die gesamte Verarbeitung des Ex- oder Imports wird durch den 
XML- Server realisiert. Dies ist ein COM- Server, der das 
Auslesen und Ubersetzten der Daten ubernimmt. Bei dem Export 
ist die Datenschicht das Basis ES, aus dem die Daten der XML- 
Files gewonnen werden. Bei dem Import ist dies umgekehrt. Die 
XML- Dateien werden ausgelesen und die Daten ins Basis ES ge- 
schrieben . 



(n) Die Interfaces des Snap- Ins 



Die Schnittstellen eines Snap- Ins ermoglichen die Kommunika- 
15 tion zwischen der Workbench und dem Server des Snap- Ins, Ein 
Snap- In mufi die Schnittstelle IUMCSnapIn implementieren, urn 
als Snap- In erkannt zu werden. Die Schnittstellen IUMCHelp 
und IUMCSnapInProperties beinhalten verschiedene Funktionen, 
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die ein Snap- In verwenden kann. Naturlich konnen andere 
Snap- Ins diese Schnittstellen implement ieren. Deswegen gehe 
ich auf diese Schnittstellen nur kurz ein und schenke der 
speziellen Schnittstelle des XML- Servers (IXMLStatus) mehr 
Aufmerksamkeit . 
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IUnknown 
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j IUMCSnapIn 

IUMCHelp Q 
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IXMLStatus ^) 
IUMCSnapInProperties ^3) mm 








9 



Abbildung0.7.: Schnittstellen des XML- Snap- Ins 

(o) IUMCSnapIn 

Die Schnittstelle IUMCSnapIn ist die obligatorische Schnitt- 
stelle fur Snap- Ins wie die IUnknown Schnittstelle von COM, 
Jedes Snap- In muft diese Schnittstelle implementieren wobei 
es unerheblich ist, ob das Snap- In eine grafische Oberflache 
besitzt oder nicht. Weiterf uhrendes Dokument zu diesem . Inter- 
face ist unter 

Werlf 452a\umc all$\doc\Icd\ICD SnapInMCD Snapln SnapInHost, 
doc zu finden. 

(p) IUMCHelp 

Um eine Hilfe zu einem Snap- In zu erhalten, ist es moglich 
mit Fl eine Hilfedatei zu offnen. Diese Funktionalitat wird 
durch das Interface IUMCHelp zur Verfugung gestellt. Zu die- 
ser Schnittstelle ist eine Dokuinentation unter 
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Werlf 4 52a\umc all$\Systemtest\Engineering SystemX Infos \Kochb 
uch ESXKochbuch ES.doc vorhanden. 

(q) lUMCSnaplnProperties 

5 Dieses Interface iibermittelt der Workbench die Eigenschaf ten 
des Snap- Ins. Das ist notig, da die Workbench sehr allgemein 
gehalten ist und keine spezifischen Daten des Snap- Ins 
kennt . Wenn ein Snap- In diese Schnittstelle implementiert, 
kann eine bestimmte Darstellung erreicht werden. Auiierdem 
10 konnen Anderungen wahrend der Laufzeit der Workbench ubermit- 
telt werden. Die Schnittstelle lUMCSnaplnProperties ist in 
dem Designdokuinent 

Werlf 452a\umc all$\doc\Icd\ICD SnapInMCD Snapln Properties, 
doc naher beschrieben. 

15 (r) IXMLStatus 

Diese Schnittstelle ermoglicht das Konvertieren eines Devi- 
ces, wobei der Typ des Devices verandert wird. Die Konvertie- 
rung erfolgt durch das Exportieren der Devicedaten und an- 

20 schlieftendes Importieren der Devicedaten. Damit hat diese 
Schnittstelle mit dem eigentlichen Export und Import eines 
Projektes nichts zu tun, verwendet aber einen ahnlichen Me- 
chanismus, urn ein Device zu konvertieren. 
4# Die Schnittstelle besitzt zwei Funktionen: ExportAndConvertE- 

25 SObject und ImportESObj ect . ExportAndConvertESObj ect expor- 
tiert und konvertiert, wie der Name schon sagt, ein Device. 
Dieser Methode muii eine DevicelD, eine TypelD und ein Ziel- 
verzeichnis ubergeben werden. Wenn das Device exportiert 
wird, 



Seite 27 von 56 



200023311 

28 

wird die alte TypelD durch die ubergebene ersetzt. Alle Dia- 
loge und Benutzeraktionen werden vernachlassigt , da der Ex- 
port nur intern im Program durchgefuhrt wird. Den eigentli- 
5 chen Export eines Devices ubernimmt der XML- Server, auf den 
ich im Kapitel 0 naher eingehen werde. Da in diesem Fall nur 
ein Teil des Projektes exportiert werden soil, wird eine Mas- 
ke gesetzt, die das spezif iziert . Die Funktion ExportAndCon- 
vertESObject liefert nach erf olgreichem Export ein String des 

10 XML- Dateinamens zuriick. 

Die Methode ImportESObj ect importiert das Device und erhalt 
den Ordner, der die exportierten Dateien enthalt, und die 
XML- Datei, die bei Export AndConvertESObj ect zurlickgelief ert 
wurde. Bei dem Import ist es ebenso nicht notwendig die Dia- 

15 loge anzuzeigen, da es sich wie beim Export urn einen internen 
Import handelt. Nun importiert der XML- Server das Device auf 
Grund der ubergebenen XML- Datei und gibt die DevicelD an die 
aufrufende Funktion zuriick. 
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Der XML- Server 

Der XML- Server ist ein ATL- Server und fuhrt den eigentli- 
5 chen Ex- oder Import der Daten durch. In diesem Kapitel werde 
ich auf die Funktionsweise und den Aufbau des Servers einge- 
hen. 

Die Dll wird in das Programm geladen, wenn die Schnittstelle 
des Servers angesprochen wird- Die Schnittstelle heilit IXML- 

10 Server und bieten zwei Methoden an. Mittels dieser Methoden 
wird der Import und der Export angestoften, deswegen heifien 
sie Startlmport und StartExport. Diese Funktionen sind die 
einzigen Funktionen, die von Auflen aufgerufen werden konnen, 
denn wie aus dem Bild ersichtlich stehen keine weiteren 

15 Schnittstellen zur Verfugung. 



IXMLServer Z^— 


lUnknown f 


p 


ill. 


linn 


f 























AbbildungO.l.: Schnittstellen des XMLServers 



(s) Der Export 

2 0 (t) Der DOM-Parser 

Der Export arbeitet mit dem Xerces Parser von Apache. Dieser 
Parser ist ein DOM- Parser, der sich dadurch auszeichnet, 
dass er einen XML- Baum aufbauen kann. Die Funktionalitat des 
25 Parsers wird in verschiedenen Headerdateien beschreiben. 
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Durch das Einfiigen dieser Dateien im Projekt stehen die Funk- 
tionen des DOM- Parsers zur Verfugung. 

Die Klassen DOM_Node, DOM_Document und DOM_Element sind die 
wichtigsten Klassen des DOM- Parsers. Ein XML- File wird 
5 durch die Klasse DOM_Document reprasentiert . Ein Tag oder E- 
lement eines XML- Files wird durch ein DOM__Element reali- 
siert, die in einem DOM_Document eingefugt werden konnen. Au- 
fierdem wird durch die Klassen DOM_Attr , DOM_Entity, DOM_Text 
und DOM_Comment weitere Funktionalitat zur Verfugung ge- 
10 stellt, urn einen Baum aufzubauen und ein XML- File zu erstel- 
len. Fortfuhrende Dokumentation zu dem DOM- Parser von Apache 
^ ist im Internet unter www.apache.de und 

www. w3 .org/TR/1998/REC-DOM-Level-l- 19981 001 /level-one- 
core . html zu f inden . 

15 

Der Aufbau des XML- Baumes wird durch den Aufruf verschiede- 
ner Funktionen des DOM- Parsers erreicht. Deswegen beinhaltet 
die Klasse CDomHelper die Grundf unktionalitat , urn die XML- 
Files zu erstellen. 
20 Ein wichtiger Member der Klasse ist die Instanz der Klasse 
DOM_Document, die eine XML- Datei erzeugt, und eine Instanz 
der Klasse DOM_Element, die das Roottag speichert. 
Wie aus dem Code ersichtlich, sind verschiedene Funktionen 
zum Beschreiben eines XML- Files vorhanden, wie writeDomDoc, 
writeDTD und writeXSL. Sie sind private Funktionen der Basis- 
klasse CDomHelper und werden am Ende des Exports einer Daten- 
menge aufgerufen. Somit wird eine XML- Datei erst nach dem 
vollstandigen Export geschrieben, urn keine inkonsistenten Da- 
ten in der Datei zu erhalten und damit die Fehlerbehandlung 
30 erleichtert wird. Das heifit, wenn ein Fehler beim Exportieren 
von Daten auftritt, konnen die fehlerhaften Daten verworfen 
werden, ohne das eine Datei von der Festplatte geloscht wer- 
den muft . 

Aufierdem ist es moglich mit den Funktionen openDomHelper und 
35 closeDomHelper Vorinitialisierungen bzw. das abschlieftende 

Schreiben der XML- Datei durchzuf tihren . Die Funktion openDom- 
Helper initialisiert die Membervariablen mit gultigen Werten 
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und legt ein DOM_Document mit einem DOM_Element an, das den 
Namen des ubergebenen Strings besitzt. In der Methode close- 
DomHelper werden die oben genannten Funktionen zum Schreiben 
des XML- Files aufgerufen. 
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Urn XLinks zu erstellen und neue Verzeichnisse anzulegen, ste- 
hen die Funktionen createSubDir, setXLink und setFullXLink 
zur Verfugung. 

Die Funktionen writeDTD und ManageNavigation sind reine vir- 
tuelle Funktionen und mussen von alien Klassen, die von der 
Klasse CDomHelper abgeleitet sind, implementiert werden. 



class CDomHelper 
{ 

public : 

CDomHelper ( ) ; 

virtual -CDomHelper () ; 



DOM_Docurnent +getDomDoc() 
DOM_Element *getDomRootNode ( ) 

of stream *getOS{) 



{ return &m_domDoc; } ; 

{ return &m_domRootElement ; } ; 

{ return &m_OS; ) ; 



/////////////////////////// 
// Static Members 
static CExport *m_pExport; 
static bool m_bSwitchXSL; 



protected: 

of stream 
of stream 
DOM_Document 
DOM_Element 
bool 



m_OS; 
m_XSL_OS; 
m_domDoc; 
m_domRoot Element ; 
m DTD Check; 



virtual void 
virtual void 
virtual HRESULT 



writeDTD( ) = 0; 

writeXSL{ ) ; 

ManageNavigation { ) « 0; 



Quellcode 0. 1.: Klassendefinition der Klasse CDomHelper 
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Wenn man nun bestimmte Daten eines Projektes exportieren 
mochte, wird eine eigene Klasse von der Klasse CDomHelper so- 
wie von der Klasse CBasisEsHelper abgeleitet. Die Klasse CBa- 
sisEsHelper ist wichtig, urn an den Pointer auf die entspre- 
chende Schnittstelle im Basis ES leichter zu gelangen, und 
wird im Kapitel (q) eingehend beschrieben. 

Bei dem Export eines Projektes werden zwei verschiedene Arten 
von XML- Dateien erstellt. Es konnen Dateien als „Linkdatei- 
en* fungieren sowie als „Datendateien* . Die „Linkdateien* 
beinhalten keinerlei Daten, sondern nur Links zu „Datendatei- 
en* und „Linkdateien* , die in einem Unterverzeichnis liegen 
(siehe Kapitel 0) . 

Urn eine „Datendatei* zu erstellen, wird die von den beiden 
oben genannten Klassen abgeleitete Klasse benotigt, die ein 
neues XML- Dokument anlegt und dies mit den zu exportierenden 
Daten fullt. Diese Daten sollten moglichst eine abgeschlosse- 
ne Datenmenge bilden. 

Diese Klasse mufl die Funktion ManageNavigation, wie in den 
folgenden Abschnitten erlautert, iiberschreiben . 
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Die Funktion ManageNavigation ist der Einstieg in die Klasse. 
Hier soil dafur gesorgt werden, dass ein XML- Dokument ange- 
legt wird, die Daten exportiert werden und das XML- File mit 
5 den exportierten Daten beschrieben wird. 

Das Anlegen der XML- Datei wird, wie oben beschrieben, durch 
die Funktion openDomHelper angestofien. Danach ist die Member- 
variable m_domRootElement auf einen gultigen Wert gesetzt, an 
die man nun weitere Elemente anfugen und somit den XML- Baum 

10 aufbauen kann. 

Fur das Exportieren einzelner Daten ist es moglich, eigene 
Funktionen zu erstellen und diese dann in der Methode Manage- 
Navigation aufzurufen. Dabei kann man die Daten zum Einen di- 
rekt an das Rootelement, das wie gesagt in der Variable 

15 m^domRoot Element gespeichert ist, anhangen oder sie anderen 

Falls unter ein neu erstelltes Element hangen, je nach Struk- 
tur der Daten im Basis ES . Das heiftt, das die Funktionen den 
ubergeordneten Knoten als Auf ruf sparameter erhalten und sie 
sich ebenso tief wie die Elemente im XLM- Baum schachteln 

20 konnen. 

Wenn alle Daten aus dem Basis ES gelesen wurden und keine 
Fehler auftraten, wird die Funktion closeDomHelper aufgerufen 
und somit die XML- Datei mit den Daten gefullt. 

4)& Eine ^Linkdatei^ wird durch eine prinzipiell genauso aufge- 

baute Klasse erstellt. Die Funktion ManageNavigation ruft die 
Methoden openDomHelper und closeDomHelper auf, urn die XML- 
Datei zu erstellen. Pro Link kann man eine Funktion anlegen, 
die in der Methode ManageNavigation aufgerufen wird. Diese 

30 Funktionen sollte einen XLink zu der entsprechenden Datei an- 
legen, eine Instanz der Klasse anlegen, die den Export der 
Daten durchfuhrt, und deren ManageNavigation Funktion aufru- 
f en . 

35 Die DTD eines XML- Files wird mit der Funktion writeDTD er- 
stellt, die wie schon erwahnt uberschrieben werden muB . Fur 
die DTD wird am Beginn des XML- Files ein String eingefugt, 
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in dem ein Makro an die dafur vorgesehene Membervariable an- 
gehangt wird. Dafur stehen die Dateien DTDHelper.h und DTDOb- 
jectDefs . h zur Verfiigung. In der Datei DTDHelper.h sind ver- 
schiedene Makros definiert, die das Erstellen einer DTD ver- 
5 einfachen sollen. In der DTDObj ectDefs . h mufi nur noch ein 
spezielles Makro fur den DTD- String definiert werden, das 
dann in der Methode writeDTD verwendet wird. 
Die XSL- Definitionen werden ahnlich erstellt und sind fur 
die Daten wichtig, die in Internet- Explorer angezeigt werden 

10 sollen. Auch hier existieren zwei Haederdateien XSLDefs .h und 
XSLDefsHelper .h, die Strings fur die XSL- Files definieren. 
I £ In der XSLDefsHelper . h sind Makros definiert, die das Erstel- 

■ len der XSL- Datei erleichtern. Die Makros fur die jeweilige 
XML- Datei werden in der XSLDefs .h Datei eingefiigt. Es mufi 

15 darauf geachtet werden, dass die neue XSL- Definition an ent- 
sprechender S telle in eine andere eingef ugt wird, wenn fur 
die XML- Datei kein eigener Ordner angelegt wird und sie sich 
mit anderen XML- Files eine XSL- Datei teilen mufi . Eine eige- 
ne XSL- Datei wird nur von den Klassen, die eine „Linkdatei* 

20 erstellen, durch die Funktion writeXSL angelegt. 

(u) Navigation uber ein Projekt 

Fur die Beschaffung der Pointer auf die Schnittstelle, die 
fur den Export angesprochen werden mufi, stehen den Klassen 
^4^5 der Export- Import- Software die Klasse CBasisEsHelper zur 
Verf ugung . 
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class CBasisEsHelper 
( 

public: 



// Konstruct / Destruct 
CBasisEsHelper ( } ; 
virtual -CBasisEsHelper () ; 



//static Basemembers 
public: 



static CComPtr<IMC_Proj ect> m_pProject; 

static CComPtr<IMC_Device> m_pDevice; 

static CComPtr<IMC_Ident> m_pTO; 

static CComPtr<IMC_Program> m_pProgram; 



static CXMLServer* m_pXMLServer ; 

static CComPtr<IUMCWBObj ectSetHandler> m_pObj ectSetHandler ; 

static long m_!Obj ectSetHandle; // Handle auf das Objectset 



static CComPtr<IUMCSnapInHost> m_pSIH; 
static CComPtr<IUMCSnapIn> m_pSI; 

static UMC_PROJECTMODE m_Pro j ectMode ; 



static std: : map<_bstr_t, _bstr_t> m_bstrChangedDeviceNameList ; 

static IsNameMapEntry*m_pTOMap; 

static long m_nTOMapSi ze; 



static unsigned long m_Export Filter ; 



Quellcode 0.2. : Klassendefinition der Klasse CBasisEsHelper 
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Diese Klasse besitzt einige Variablen, die auf wichtige 
Schnittstellen zeigen. Von ihnen aus konnen andere Interfaces 
angesprochen werden. Dariiber sind die benotigten Schnittstel- 
len zu finden. Die wichtigsten Interf acepointer sind zu den 
Schnittstellen IMC__Proj ect, IMC_Device, IMC_Ident und 
IMC_Program. AuJierdem gibt es noch Pointer zum Snap- In, zum 
Snap- In- Host und zum XMLServer fur die Ausgaben beim Im- 
und Export. Urn die Daten bearbeiten zu konnen, mussen sie an 
ein sogenanntes „ObjectSet* der Schnittstelle IUMCWBObj ect- 
SetHandler gebunden werden. Auf dieses Interface zeigt die 
Membervariable m_pObj ectSetHandler . 
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Neben den Variablen sind verschiedene Funktionen definiert. 
Daten, die in ein XML- File geschrieben werden, mussen in 
Strings vorliegen. Deswegen sind in der Klasse CBasisEsHelper 
5 mehrere Methoden zum Konvertieren von Daten in Strings und 
umgekehrt vorhanden. Fur das „Ob j ectSet* sind verschiedene 
Funktionen definiert, die Objekte dem „ObjectSet* hinzufligen 
und entfernen konnen. 



10 Die Daten eines Projektes sind unter verschiedenen Schnitt- 

stellen abgelegt. Urn an ein Interface zu gelangen, das die 
^ gewunschten Daten enthalt, ist es manchmal notwendig uber 

verschiedene andere Schnittstellen zu navigieren. Fur das im 
Kapitel (c) beschriebene Beispiel, war es notig uber zwei 

15 weitere Schnittstellen das Interface anzufordern. Wie aus der 
Abbildung 0.2 ersichtlich, ist es moglich die Schnittstellen 
durch Aufrufen von Querylnterface und getObj ectBylD zu erhal- 
ten . 



IMC_Project 



IMC Ident 



Querylnterface 



ge t Obj e c tBylD 



Qu eryln t erf a ce 



IMC_Project 
Navigate 



I MC_A1 a rms_ 
S_Navigate 



20 



Abbildung 0.2. : Navigieren zu den Interface fur den Export der AJarme 



Eine Dokumentation uber die Schnittstellen des Basis ES und 
eine Beschreibung, wie verschiedene Interfaces angesprochen 
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werden, ist unter 

Werlf 452a\uittc all$\doc\ICD\icd basis es.doc vorhanden. 
(v) Ein Beispiel fur den Export - exportieren von Alarmen 

5 Um die Funktionsweise and den Aufbau des Exports verstandli- 
cher zu machen, erlautere ich den Export am Beispiel des Ex- 
ports von Alarmdaten . 

Die Stelle, an der das Programm erweitert werden mull, ist ab- 
hangig von den Daten, die exportiert werden sollen, da der 
10 Export die Dateien in einer Verzeichnishierarchie ablegt, die 
der Hierarchie des Projektes im SIMOTION SCOUT- Programm ahn- 
lich ist (siehe Kapitel 0) . Die Alarme sind pro j ektglobal, 
deswegen sind sie auf der ersten Ebene zu exportieren. 

15 Da die Alarme nicht von anderen Daten im Projekt abhangig 
sind, legt der Export fur diese Daten eine neue XML- Datei 
an. Deswegen ist es vorteilhaft fur den Export der Alarme ei- 
ne neue Klasse anzulegen. Diese Klasse heifit CAlarmNavigati- 
on. Sie besitzt alle Eigenschaf ten, die eine „Navigation- 

20 Klasse* hat und ist wie folgt aufgebaut. 
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class CAlarmNavigation : 

public CBasisEsHelper, 
public CDomHelper 

{ 



public: 



//Const ruction/ Destruction 

CAlarmNavigation (_bstr_t bstrExport Path ) ; 
virtual -CAlarmNavigation {) ; 



//■ 



// public methods 



//- 



H RESULT ManageNavigation ( ) ; 



private : 



// private methods 

HRESULT getTargetLanguage ( ) ; 
H RESULT getCurrentLanguage ( ) ; 



Quellcode 0.3. : Klassendefinition der Klasse CAlarmNavigation 



10 



Der Einstiegspunkt fur den Export eines Projektes ist die 
Klasse CProjectNavigation. Pro j ektglobale Daten werden, von 
dieser Klasse ausgehend, exportiert. Das heifit die Klasse CA- 
larmNavigation wird in der Klasse CProjectNavigation angelegt 
und abgearbeitet . Dafur wird eine neue Funktion getAlarms in 
der Klasse CProjectNavigation angelegt. Die Funktion Manage- 
Navigation der Klasse CProjectNavigation mufl urn den Aufruf 
der Funktion getAlarms erweitert werden. 
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if ( {m_Export Filter & XMLDATA_ PROJECT EXT ) == XMLDATA_PROJECTEXT ) { 

hr = gpt A1 a rms ( ) ; 

Quellcode 0.4. : Funktion ManageNavigation in der Klasse CProjektNavigation 

Die Funktion getAlarms der Klasse CProj ectNavigation erstellt 
einen Link zu der XML- Datei der Alarme. Er zeigt auf die 
XML- Datei, die spater die Alarme enthalt. Uber diesen Link 
ist es moglich vom Projekt auf die Alarme zuzugreifen, was 
fur den Import wichtig ist. Auflerdem muB die Funktion getA- 
larms eine Instanz der Klasse CAlarmNavigation anlegen und 
dessen ManageNavigation Funktion aufrufen. 
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HRESULT CProjectNavigation: rgetAlarms ( ) 
{ 

HRESULT hr = S_OK; 

// Create Dom Node ProjecData 

DOM_Element domAlarms = m_domDoc. cr eat eElement ( "UMC_A1 arms" ) ; 
m_domRoot Element . appendChild {domAlarms ) ; 

setXLink (domAlarms, _T { "Alarms" ) ,XLINK_FILE) ; 

Q uellcode q 5 . punj^on getAlarms der Klasse CProjektNavigation — — ~— — 

Im Konstruktor der Klasse CAlarmNavigation wird eine neue 
XML- Datei angelegt, die Alarms . xml heiiit. AuBerdem wird die 
Membervariable m__pstrDataExportPath gesetzt, die den Pfad der 
Datei angibt. 

Nach dem Durchlaufen des Konstruktors durch das Anlegen einer 
Instanz der Klasse CAlarmNavigation wird nun die Funktion Ma- 
nageNavigation aufgerufen. 

Diese Funktion ubernimmt die Organisation des Exports. Die 
Daten, der Alarme liegen im Basis ES . Es muB also zuerst ein 
Pointer auf das Interface angefordert werden. Danach werden 
alle relevanten Daten mit Hilfe einzelner Funktionen aus dem 
Basis ES gelesen. 
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HRESULT CAlarmNavigation: : ManageNavigation ( ) 
{ 

HRESULT hr = S_OK; 

hr = getlnterf acePointer { ) ; 

if (FAILED (hr) ) 
{ 

m_pExport->throw_Error ( get_ResString ( I DS_EX_ERR_NAVALARMS ) ) ; 
return E_FAIL; 

} 

hr = openDomHelper (_T { "Alarms" ) ) ; // root Node Name 

hr = getVersion ( ) ; 
if ( FAILED ( hr ) ) 

return E FAIL; 



hr = getCurrentLanguage ( ) ; 

if ( FAILED ( hr ) ) 

Quell code 0.6. : Funktion ManageNavigation der Klasse CAlarmNavigation 

Den Schnittstellenzeiger auf das Interface 

IMC_Alarm__S_Navigate erhalt man nur uber Umwege, Ausgehend 
vom Projekt wird ein Querylnterface auf die Schnittstelle des 
Proj ektnavigators IMC_Proj ectNavigate gemacht. Der Zeiger auf 
diese Schnittstelle enthalt die globalen Objekte, die mit dem 
Aufruf der Funktion getObj ectBylD angesprochen wird. Hier ist 
es nun moglich ein Querylnterface auf das gewtinschte Inter- 
face zu machen und dies einer Membervariable zuzuweisen. 
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HRESULT CAlarmNavigation : : get Inter face Pointer ( ) 
{ 

// get a pointer to the interface of pro j ectnavigation 

CComQIPtr<IMC_Proj ectNavigate, & IID_IMC_Proj ectNavigate> pPN (m_pProj ect ) , 

if (pPN == 0) 

return E_FAIL; 

IMC_Ident * pldent = NULL; 
DWORD ret = 0; 

// get a pointer to the interface of the global objects 
// form the proj ectnavigation 

HRESULT hr = pPN->getObj ectBylD (ESObj ectID_PmGlobCommon, &pldent, &ret ) ; 

i f ( ( FAILED ( hr ) ) || (ret !=BUMC_OK)) 
{ 

SafeRelease {pldent ) ; // freigeben 
return E FAIL; 



Quellcode 0.7. : Schnittstellenzeiger filr die Alarme 



m 



10 



15 



Wenn der Schnittstellenzeiger initialisiert ist, konnen die 
Daten aus dem Basis ES gelesen werden. Fur den Export der A- 
larme sind verschiedene Daten wichtig, wie die Version, die 
CurrentLangvage, die TargetLanguage, die NumberRange und die 
Alarmdaten an sich. 

Die Alarme gliedern sich in verschiedene Sprachen. Das heifit 
zuerst mufi man sich von der Schnittstelle die Liste der Alar- 
me (Funktion getAlarmsList) holen. Dann ist es moglich mit 
Hilfe der Daten eines Alarms (Funktion getAlarm) die ver- 
schiedenen Sprachen eines Alarms (Funktion getLanguageList) 
zu erhalten^ Ausgehend von dem Alarm kann man jetzt den Text 
in der zugehorigen Sprache vom Interface erfragen (Funktion 
getAlarmText) . Jede Funktion sollte die Daten, die sie erhal- 
ten hat, in das XML- File schreiben. 
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Der oberste Knoten heiftt Alarm und wird in der Funktion getA- 
larmsList gefiillt. 



m 
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HRESULT CAlarmNavigation: : getAlarmsLi st ( ) 
( 

HRESULT hr = S_OK; 

long size = 0; 

ESAlarmID * IDlist ■ NULL; 

// get the list of the alarmlDs 

hr = m_pIAlarm->GetAlarmIDList { isize, &IDlist ) ; 

i f ( ( FAILED (hr ) ) II (IDlist — NULL) ) 
{ 

m_pExport-> 

throw_Error ( get_ResString ( IDS_EX_ERR_ALARM_LIST ) ) ; 
return E_FAIL; 

} 

// get the Alarm for each ID in the list 

for(int i = 0; i < size; i++) 

{ 

char string[256] = {0); 

// create a new element 

Quellcode 0.8. : Funktion getAlarmsList der Klasse CAlarmNavigation 

Wie man in diesem Ausschnitt sehen kann, wird das DOM^Element 
der getAlarm Funktion mit gegeben. Diese Funktion kann somit 
ein DOM_Element unter das ubergebene hangen. Aulierdem ruft 
die Funktion getAlarm die Funktion getLanguageList auf und 
ubergibt dieser das neue DOM_Element. 

Die Funktion getLanguageList hangt wiederum ein neues 
DOM_Element an das ubergebene. Somit wird DOM- Baum aufge- 
baut, dessen letztes Element der Alarmtext in einer bestimm- 
ten Sprache ist. 
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HRESULT CAlarniNavigation: : getAlarmText (DOM_Element * parentNode, ESAlarmLanguagelD Langua- 

gelD, ESAlarmID dwAlarmID) 

{ 

HRESULT hr = S_OK; 

DWORD ret - 0; 

ComMCAlarmSTextData TextData; 

// get the text of the alarm 

hr - m_pIAlarm->GetRawText (dwAlarmID, LanguagelD, &TextData, &ret ) ; 

// connection to the interface was succseeded 
if (SUCCEEDED (hr) ) 

{ 

// can't found the text of the alarm 

if (ret == BUMC_NOT_FOUND) 

{ 

wchar_t buffer {256] - {0}; 
char alarmstring[256] = {0}; 
char langstring ( 256) = {0}; 

_ultoa {dwAlarmID, alarmstring, 10 ) ; 

if (GetLocalelnfo (MAKELCID { LanguagelD, SORT_DE FAULT ) , 

LOCALE_S LANGUAGE, langstring, 255) == 0 ) 
strcpy (langstring, ) ; 

_snwprintf {buf f er, si zeof (buf f er ) , 

get_ResString ( I DS_EX_WAR_ALARM_TEXT ) r 
m_szAlarmName, langstring) ; 

m_pExport->throw_Error (buffer) ; 

return E FAIL; 

Quellcode 0.9. : Funklion getAlarmText der Klasse CAlarmNavigation "~ — — 



Seite 47 von 56 



200023311 



48 

Mit diesen Schritten ist es moglich alle Daten der Alarme ei 
nes Projektes zu exportieren. Um die Datei im Internet Ex- 
plorer anzuzeigen, muB jedoch eine DTD und ein XSL- File vor 
handen sein. Fur die DTD existiert die Funktion" writeDTD in 
der Klasse CDomHelper, die uberschrieben werden muli. Um den 
String der DTD zusammen zusetzten, kann man in der Datei 
DTDObjectDefs.h eine #define anfugen. Die grundlegenden Defi 
nes sind in der Datei DTDHelper.h schon definiert. 
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///////////////////////////////////////////////////////////////////////////// 




// Alarms 






// 






ff define DTD_ALARMS 


\ 




DTD_D( "Alarms") 


\ 
\ 


« 


DTD_E ( "Alarms {Version, Cur rent Language, Target Language, IDRange?, " 


\ 


« 


"Alarm* ) " ) 


\ 


« 


DTD_E ( "Version { 0 PCDATA) " ) 


\ 


« 


DTD_A( "Version GUID CDATA # REQUIRED Major CDATA ^IMPLIED " 


\ 


« 


"Minor CDATA ^IMPLIED") 


\ 


« 


DTD_E{ "Cur rent Language (# PCDATA) " ) 


\ 


« 


DTD_A( "CurrentLanguage LanguagelD CDATA # REQUIRED " 


\ 


« 


"Name CDATA # REQUIRED" ) 


\ | 


« 


DTD_E ( "Target Language (# PCDATA) " ) 


\ 


« 


DTD_A( "TargetLanguage LanguagelD CDATA REQUIRED " 


\ 


Quellcode 0.10.: DTD der Alarme 



Das XSL- File wird auch durch Defines erstellt. Diese Defines 
stehen in der Datei XSLDefs.h und basieren auf Defines der 
XSLDefsHelper.h Datei. 
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///////////////////////////////////////////////////////////////////////////////// 

// ALARMS XSL 
// 

^define XSL_ALARMS \ 

\ 

XSL_ALARMS_LANGUAGE \ 

« XSL_T( "Alarms", \ 

X S L_H TM L_ TON T ("Arial Black" ," 3" , "Alarms" ) \ 

« " <TABLE STYLE~\"border:lpx solid black\">\n" \ 

« " <TR STYLE=\ " font-si ze : 12pt; font-family: Verdana; " \ 

« "font-weight :bold\">\n" \ 

« " <TD>Symbol</TD>\n" \ 
« " <TD STYLE=\"background-color: lightgrey\ ">Language</TD>\n" \ 

« " </TR>\n" \ 

« " <xsl : for-each select=\ "Alarm\">\n" \ 

« " <xsl : for-each select=\ "Alarmdata\">\n" \ 

« " <TR>\n" \ 

« n <TDXxsl : value-of select=\ " @Symbolname\ "/></TD>\n" \ 

« " <TD STYLE=\"background-color:lightgrey\">\n" \ 



Quellcode 0.1 1.: XSL- Datei der Alarme 



(w)Der Import 

5 (x) Der SAX- Parser 



Der SAX- Parser ist ein ereignisgesteuerter Parser, der beim 
Auftreffen auf ein XML- Tag in eine Funktion verzweigt. Es 
wird kein XML- Baum im Speicher gehalten, was der Performance 
10 zu Gute kommt. Durch diese Funktionalitat ist dieser Parser 
fur den Import eines Projektes geeignet. 

Um den SAX- Parsers zu nutzen, sind die Headerdateien des 
•Parsers im Projekt eingezogen. Der Parser besteht aus der 
Klasse HandlerBase und besitzt mehrere Funktionen, die von 
15 ihm bei bestimmten Ereignissen aufgerufen werden. Die Funkti- 
onen sind nur definiert und die endgultige Implementierung 
wird erst von dem Programmierer in einer abgeleiteten Klasse 
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durchgef iihrt . Damit kann man die Funktionen speziell auf das 
zu losende Problem zuschneiden. Weiter f iihrende Dokumentation 
dazu ist auf der Seite www.apache.de oder 
www . megginson . com/ SAX/ index , html zu f inden . 

In der XML- Software ist die Klasse CSAXHandler von der Klas- 
se HandlerBase abgeleitet. Diese Klasse iiberschreibt , wie aus 
dem Code ersichtlich, alle Funktionen der Klasse HandlerBase. 
Wichtig fur die Software sind davon allerdings nur die Funk- 
tionen startElement, endElement, characters und fur die Feh- 
lerausgabe die Funktionen warning, error und FatalError. 
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class CSAXHandler : public HandlerBase, public CImportBase 
{ 

public: 

bool Element I sNormalTOType (_bstr_t bst rElementName ) ; 
bool ElementIsNormalTO(_bstr_t bst rElementName ) ; 
HRESULT GetResult(); 

void SetParseFile (_bstr_t bstrFile); 

bool GetDoValidation ( ) { return m_bDoValidation; } 

//Attributes 

static CParseManager * m_pParseManager ; 

static IsNameMapEntry * m_pTONameMap; 

static long m_lTONameMapSize; 

CSAXHandler ( ) ; 

CSAXHandler (_bstr_t bstrHandlerType ) ; 

CSAXHandler (_bstr_t bstrHandlerType, bool bDoValidation ) ; 
virtual -CSAXHandler <) ; 

protected: 

_bstr_t m_bstrParseFile; 
bool m_bErrorOccured; 
_bstr_t m_bstrHandlerType; 
bool m_bDoValidation; 

public: 

// 

// methods to be overwridden by the derived classes 

// 

virtual void HandleStartElement ( const XMLCh* const name, AttributeListfc attributes); 
virtual void HandleEndElement ( const XMLCh* const name); 

virtual void HandleCharacters (const XMLCh* const chars, const unsigned int length) ; 
~~ — Q ue | lcode 0.12.: Klassendefinition der Klasse CSAXHandler ~~ 
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Der Import beginnt in der Klasse CParseManager durch den Auf 
ruf der Funktion ParseProj ect ♦ Hier werden einige Initiali- 
sierungen vorgenommen und der Import des gesamten Projektes 
wird angestoJSen. 

Beim Parsen eines Startelementes ruft er SAX- Parser die 
Funktion startEl ement der Klasse CSAXHandler auf. Die Funkti 
on unterscheidet, ob das Tag ein Link oder ein normales Ele- 
ment ist. 
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Wenn ein Link gefunden wird, stoiit die Funktion das Parsen 
der im Link enthaltenen Datei an. Urn diese Funktionalitat bei 
alien Dateien mit Links zu gewahrleisten, wird fiir jede XML- 
5 Datei eine sogenannte „Handlerklasse* erstellt, die von der 
Klasse CSAXHandler abgeleitet ist. 1st das gefundene Tag ein 
Link, wird ein Pointer auf die Handlerklasse initialisiert, 
die diese XML- Datei parsen soli. Danach wird das Parsen der 
Datei durch die Funktion ParseXLinks der Klasse CParseManager 
10 angestoBen. 

Beim Parsen von Elementen muiJ man jedoch anders vorgehen. Da- 
^ fur stehen die Funktionen HandleStartElement, HandleEndEle- 
ment und HandleCharacters zur Verfugung. Sie werden von den 
„Handlerklassen* entsprechend uberschreiben . Wenn die Funkti- 
15 onen startElement, endElement und characters mit einem Ele- 
ment aufgerufen wird, rufen sie die entsprechende der drei 
Funktionen HandleStartElement, HandleEndElement und Handle- 
Characters auf. 

2 0 (y) Handeln von Projektkomponenten 

Zum Importieren sollte eine „Handlerklasse* pro zu importie- 
render XML- Datei existieren. Diese Klassen sind von der 
^ Klasse CSAXHandler abgeleitet und erben somit die Funktiona- 

25 litat der Basisklasse. 

Wie beim Export kommt es beim Import auch auf den Inhalt der 
Dateien an. Bei einer Datei, die ausschliefilich Links ent- 
halt, wird die Funktion startElement der Basisklasse urn IF- 
Abfragen erweitert. Wenn dagegen XML- Files mit Daten geparst 

30 werden sollen, kann man die Klassen wie folgt anlegen. 

Die Klassen mussen die Funktionen HandleStartElement , Hand- 
leEndElement und wenn notig HandleCharacters uberschreiben. 
Sie werden aufgerufen, wenn der Parser auf ein Start- Oder 
Endelement bzw. auf einen Text getroffen ist. Dann ist es 

35 moglich in einer dieser Funktionen abzufragen, welches Tag 
der Parser gefunden hat. Somit kann dort eine Funktion zum 
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Auslesen der Daten aus dem gefundenen Element aufgerufen wer- 
den. Urn das Auslesen zu kapseln, sollten die Funktionen in 
einer sogenannten „Makeklasse* definiert werden. Die „Hand- 
lerklasse* besitzt als Membervariable einen Pointer auf die 
„Makeklasse* , die genau die Daten importiert, die das XML- 
File beinhaltet. Der Pointer wird im Konstruktor der „Hand- 
lerklasse* angelegt und im Destruktor freigegeben. Wenn ein 
Element gefunden wurde, das Daten fur den Import enthalt, 
dann wird in einer der drei oben genannten Funktionen eine 
Funktion der „Makeklasse* aufgerufen. 



class CAlarmHandler : public CSAXHandler 
{ 

public : 

//=======™= ===================== 



//Construction/Destruction 

CAlarmHandler { ) ; 

virtual -CAlarmHandler {) ; 



// public methods 



Quellcode 0.13.: Beispiel far eine „Handlerklasse" 

(z) Anlegen von Projektkomponenten mit „Makeklassen" 



Urn die Daten zu importieren werden die Funktionen einer soge- 
nannten „Makeklasse* aufgerufen. Ein Beispiel fur eine solche 
„Makeklasse* ist im Quellcode 0.17 vorhanden. 

Diese Klassen sind von der Klasse CBasisEsHelper abgeleitet. 
Damit sind alle Member und Funktionen der CBasisEsHelper 
Klasse der „Makeklasse* bekannt. Dies ist notwendig da die 
Daten in das Basis ES geschrieben werden mtissen. Die Naviga- 
tion zu dem Pointer auf die Schnittstelle, die beim Schreiben 
der Daten angesprochen wird, ist im Kapitel (b) schon fur den 
Export erklart. Aufierdem befinden sich die Schnittstellen zum 
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Schreiben und Lesen meist an dem gleichen Interface. Deswegen 
ist die Dokumentation liber die 



Seite 56 von 56 



200023311 



57 

Navigation zu den gewunschten Interface nicht nochma-ls in 
diesem Kapitel enthalten. Der Pointer kann nun in einer Mera- 
bervariable gespeichert werden, da eine Instanz der „Ma- 
5 keklasse* wahrend des Parsens eines XML- Files im Speicher 
bestehen bleibt. 

Die „Makeklassen* benotigen nur Funktionen, die Daten eines 
Tags importieren. Es ist moglich Daten beim Auftreffen auf 
ein Element in das Basis ES zu schreiben oder beim Finden ei- 

10 nes Endtags . Dies ist wichtig, wenn Daten von Elementen, die 
darunter geschachtelt sind, zum Anlegen der Daten im Basis ES 
^ benotigt werden. 

Somit kann man fur jedes Starttag und Endtag eine eigene 
Funktion definiert werden. Darin werden die Daten der Elemen- 

15 te ausgelesen. Dabei gibt es mehrere Moglichkeiten, wie die 
Daten im Tag eingebunden sind. Wenn sich ein Element aus an- 
deren zusammensetzt, dann sind die Daten in den darunterlie- 
genden enthalten. Jedes Tag kann natiirlich auch eigene Daten 
besitzen, die in dessen Attributen gespeichert sind. Die ein- 

20 fachste und herkommlichste Art die Daten eines Elements zu 
speichern, ist jedoch im Text zwischen Start- und Endtag. 
Wenn die Daten aus dem Tag gelesen wurden, konnen sie mit 
Hilfe des Pointers auf die entsprechende Schnittstelle in das 
Basis ES geschrieben werden. Wenn dabei Fehler auftreten, 
j)5 sollte auch hier eine Fehlerausgabe erfolgen. 

(aa) Ein Beispiel fur den Import - importieren von Alarmen 

Wie beim Export soil auch an dieser Stelle ein Beispiel das 
in diesem Kapitel Beschriebene verdeutlichen . 
30 Der Import ist ereignisgesteuert und ruft bei einem Ereignis 
(Element) die Funktion startElement der Klasse CSAXHandler 
auf. Hier werden die Links ausgewertet. In diesem Beispiel 
ist das Ereignis „Link auf eine Datei Alarms . xml* wichtig, 
der das Auslesen dieser Datei anstoBt. 
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else if (bstrElementName == _bst r_t ( U7 DXML_ALARMS ) ) 



Quellcode 0. 14.: Importieren des Links auf die Datei Alarms, xml 

Die Variable pEventHandler der CSAXHandler Klasse wird mit 
einem Pointer auf die jeweilige ^Handlerklasse^ initiali- 
siert. In dem Fall der Alarme ist dies die Klasse CAlarmHand- 
ler. Wenn dieser Pointer initialisiert wurde, kann die Funk- 
tion ParseXlink der Klasse CParseManager aufgerufen werden, 
die dafur sorgt, dass das im Link enthaltene File geparst 
wird. 



if (pEventHandler) 
{ 

// parsing Xlink file with the created parse handler 

Quellcode 0.15.: Starten des Parsens eines XML- File ~~~ "™~ = — — — — — — 

Wenn die Funktion startElement der Basisklasse CSAXHandler 
jetzt aufgerufen wird, verzweigt diese die Funktion Hand- 
leStartElements . Ebenso wird bei endElement der CSAXHandler 
die Methode HandleEndElements aufgerufen. Die Klasse CAlarm- 
Handler uberschreibt diese Funktionen, so dass dort eine 
spezielle Bearbeitung der XML- Datei umgesetzt werden kann. 
Durch den Pointer auf die „Makeklasse* CMakeAlarm kann auf 
Funktionen zugegriffen werden, die Alarme im Basis ES anle- 
gen . 
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void CAlarmHandler : : HandleSta rtElement { const XMLCh *const name, Att ributeList &attributes) 
{ 

_bstr_t bstrElementName { name ) ; 

if (bstrElementName == _bstr_t (U7DXML_CURRENT_LANGUAGE ) ) 
{ 

UMCINFO "HandleStartElement for: %s", ( char* ) bstrElementName END 
m_pMakeAlarm->setCurrentLanguage (name, attributes) ; 

} 

else if (bstrElementName == _bstr__t ( U7DXML_TRAGET_LANGUAGE ) ) 
{ 

UMCINFO "HandleStartElement for: %s", { char* ) bst rEl ementName END 
m_pMakeAlarm->setTargetLanguage (name, attributes ) ; 

} 

else if (bstrElementName == _bstr_t (U7DXML_IDRANGE ) } 

s { 

UMCINFO "HandleStartElement for: %s", ( char* ) bstrElementName END 
m_pMakeAlarm->setIDRange (name, attributes) ; 

} 

else if (bstrElementName <== _bstr_t (U7DXML_ALARM) ) 

Quellcode 0.16.: Auslesen der Anfangselementc 

Den eigentlichen Import der Projektdaten ubernimmt die Klasse 
CMake Alarm. Wenn ein Element im XML- File gefunden wurde, das 
Daten enthalt, die fur den Import wichtig sind, wird eine 
Funktion der Klasse CMakeAlarm aufgerufen, die diese Daten 
ins Basis ES schreibt. 
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class CMakeAlarm : public CBasisEsHelper 
{ 

public : 

//============================ = ==== === ^ == ^ ================= « == « ======= 

//Const ruction/ Destruction 

//==^ = = ========= ^^^^^ == , = ^^^ ======= ^ ====== _^ === ^^_ = ^ == ^ ====== _ ==== ^^ 

CMakeAlarm( ) ; 

virtual ~CMakeAlarm( ) ; 

//========================== == ======== ================================= 

// public methods 

//===========^========================^ 

void setAlarmText ( const XMLCh *const name, AttributeList &attributes ) ; 
void endAlarmText ( const XMLCh * const name); 

void setLanguage (const XMLCh *const name, AttributeList &attributes ) ; 
void endLanguage ( const XMLCh *const name); 

void setAlarmData (const XMLCh *const name, AttributeList ^attributes ) ; 
void endAlarmData ( const XMLCh *const name); 

Quellcode 0. 17.: Importfiinktionen ftlr AJarme ' 

In den Methoden der Klasse CMakeAlarm werden die Daten aus 
den XML- Elementen gelesen und liber ein Interface in das Ba- 
sis ES geschrieben. Die Schnittstelle, die das Schreiben der 
Daten ermoglicht , heilit IMC_Alarm_S_Edit und ist uber die 
selben Schnittstellen zu erreichen, wie die beim Export beno- 
tigte Schnittstelle. An diesem Interface werden dann die 
Funktionen zum Schreiben der Alarmdaten aufgerufen. 
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void CMakeAlarm: : setAlarmData (const XMLCh *const name, Att ributeList &attributes) 
{ 

H RESULT hr = SJDK; 
DWORD ret = 0; 

ComMCAl armS Data alarmdata; 

// get attributes 

_bstr_t bstrSymbolName - attributes . getValue ( "Symbolname" ) ; 
alarmdata. SymbolName = bstrSymbolName; 

_bstr_t bstrMsgType = attributes . getValue ( "MsgType" ) ; 
alarmdata .MsgType - atoi {( char* } bstrMsgType ) ; 

_bstr_t bstrMsgClass = attributes . getValue ( "MsgClass" ) ; 
alarmdata .MsgClass = atoi (( char* ) bstrMsgClass ) ; 

_bstr_t bstrMsgText = attributes . getValue ( "MsgTextLocked" ) ; 
alarmdata. Msgtextlocked = atoi (( char* ) bstrMsgText ) ; 

_bstr_t bstrlnfoText = attributes . getValue ( " Inf oTextLocked" ) ; 

Quellcode 0.18.: Schreiben von Daten in das Basis ES 
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Kommunikation mit Step7 

Die dritte und letzte Dll der Export- Import- Software, ist 
fur den Export und Import von den bei SIMOTION SCOUT enthal- 
tenen Step7- Anteilen zustandig. Die Hardwarekonf iguration 
eines Projektes kann mit der Export funktion von Step7 expor- 
tiert werden. Fur den Import steht ebenso eine Funktion von 
Step7 zur Verfiigung. Die Daten werden im ASCII- Format ge- 
speichert. Deswegen konnen die schon vorhandenen Funktionen 
von Step7 fur den XML- Export- Import verwendet werden. 
Die Schnittstelle, die dafiir von AuBen angesprochen werden 
muii, ist IXMLS7Project . Sie stellt die zwei Funktionen zum 
Export bzw. zum Import der Daten zur Verfiigung . Deswegen hei- 
Ben diese Funktionen Import und Export. 




Abbildung 0.1.: Schnitlslellen des S7Servers 

Urn bei dem Export und dem Import nicht auf direkt auf das 
Step7 zuzugreifen zu miissen, ubernimmt ein sogenannter Daemon 
diese Aufgaben. Es werden Funktionen des Daemon aufgerufen, 
dieser „uberset zt* die Aufrufe und fuhrt die entsprechenden 
Aktionen bei Step7 durch. 
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Abbildung 0.2. : Daemon des Step7 Export- Import 



Der Export sowie der Import der Step7- Projekte werden in der 
Klasse CXMLS7 Project durchgef uhrt . 
5 Fur den Export wird in dieser Klasse die Funktion Export auf- 
gerufen. Hier werden die Funktionen OpenProj ectS7 , ChooseRe- 
levant Stations, ExportRelevantStations und CloseProj ektsS7 
aufgerufen. Damit wird zuerst das zu exportierende Projekt 
und die darin enthaltenen Stationen ausgewahlt. Dann werden 
10 die Stationen durch ExportRelevantStations exportiert. Das 

Schlieflen des Projektes wird mit Hilfe der Methode ClosePro- 
jektsS7 ermoglicht. 

Beim Importieren wird die Funktion Import aufgerufen. Das 
Offnen und Schliefien des Step7- Projektes ubernehmen auch 

15 hier die Funktionen OpenProj ectS7 und CJosePro- 

jektsS7. Weiterhin werden die Funktionen GetCurrentS7Handle, 
CompareStationNames und ImportOneStation verwendet. Die Me- 
thode CompareStationNames wird benotigt, um das Importieren 

& einer schon im Projekt vorhandenen Station zu verhindern. 

20 Wenn Stationen importiert werden sollen, muii die Methode Im- 
portOneStation fur die zu importierende Station aufgerufen 
werden . 
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Das Format und die Hierarchie der exportierten Daten 

Ein exportiertes SIMOTION SCOUT- Projekt wird in einer Ord- 
nerstruktur abgelegt. Diese Struktur ist angelehnt an den 
Aufbau eines Projektes im SIMOTION SCOUT- Pro j ektnavigator , 



UMC - Projekt 



Projekt Bee/fce.tan Einfugen Z.elfcystem Ansicfo Extras Fertster HiJte 
H|j<Kein Fi|ter> ^] [~FWf 8 sum.. ] ' 

II—— 3 • " ^ J| 



IS! 



Projekt 

:-- /t\ Hetdware konfigurieren 
i$BBJ Device 

ABLAUFSYSTEM 
! G- 10 
! a-^JACHSEN 

:- Neue Achse dnfiigen 
ir)"^ Postbnserungsechse 
*• £j NOCKEN 
;-- > Benut2erdaten 
I 0 OE] MESSTASTER 

I • A\ Neuen Messtestei einfiigen 
B «S Messtester 

••• > Konfiguration 
- > Slendardwerte 
I— > Konfiguiation 
I- > Mecharft. 
j— > Regdung 
|. - > dyn. Regtefdaten 



> Begrenzungen 
•••• > Uberoechungen 
i EXTERNE SENSOREN 
! KURVENSCHEIBEN 
Kluvemchebe 
; Neue 

SCLProgT 
| BEOBACHTEN 




Sie arbeiten im Otlline-Moclus ! 



Abbildung 0. 1 .: Aufbau eines Projektes im Proj ektnavigator 

Die grofle Menge der Daten eines Projektes wird in geglieder- 
ten Datenblocken gespeichert. Damit wird eine ubersichtliche 
Datenhaltung moglich gemacht, die dem Benutzer nach dem Ex- 
port immer noch logisch erscheint. Ein anderer Gesichtspunkt 
fur eine solche Hierarchie, ist die Moglichkeit, Komponenten 
eines Projektes zu analysieren oder uber das Internet zu ver- 
schicken, ohne das unwichtige Daten storen. 
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(bb) Die Hierarchie der exportierten Daten eines SIMOTION SCOUT- Projek- 
tes 

Ordner : MyPro j ectDataFolder 
Projekt .xml 
Ordner: Projekt 
Pro j ekt . xml 
Alarms. xml 
Installation . xml 
Ref erenceTable .xml 
S7ProjectData.xml 
Ordner: Device 
Device . xml 
RunTimeLevels . xml 
DeviceData . xml 
Device_Symbols . xml 
Ordner : ProcessingUnit 
ProcessingUnit . xml 
SCL-Programm. xml 
Ordner: TOCamType 
TOCamType.xml 
Kurvenscheibe .xml 
Ordner : TOPosAxis 
TOPosAxis . xml 

Ordner : Positionierungsachse 
Positionierungsachse . xml 
ExpertList . xml 

3 o (cc) Erlauterung zu den exportierten Dateien 

In der Hierarchie werden unterschiedliche XML- Dateien ange- 
legt. Dateien konnen ausschlieJilich Links enthalten oder aus- 
schliefilich Daten. Die Dateien, die Links enthalten, liegen 
35 in einem gleichnamigen Ordner und sind die Dateien, durch die 
der Einstieg in diesen Ordner ermoglicht wird. Die Links, die 
in den Dateien enthalten sind, verweisen auf XML- Dateien, 
die fur die Datenhaltung zustandig sind und im gleichen Ord- 
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ner liegen. Aufterdem konnen die Links auch auf die Einstiegs- 
dateien der Unterordner zeigen. Durch dieses Prinzip wird die 
Portierbarkeit vereinfacht. Das heiftt es ist gewahrleistet , 
einen Ordner aus der Hierarchie zu nehmen, ohne das die 
5 Struktur verloren geht . Somit konnen relevante Daten an Drit- 
te weiter gegeben werden ohne unnutze Dateien mit zuliefern. 

Ordner : MyPro j ectDataFolder - Der Ordner enthalt das ge- 
samte exportierte Projekt mit alien XML- 
10 Dokumenten, XSL- Dateien, HTML- Sei- 

ten und gegebenenf alls Unterordnern, 
Jm^ die alle Daten des Projektes mit 

dessen speziellen Eigenschaf ten im 
XML- Format beschreiben. Der Name 
15 dieses Ordners wird durch den Benut- 

zer gewahlt (siehe Kapitel (g) ) 
Zu diesem Ordner existiert eine XML- 
Datei, die das Projekt im ganzen 
verlinkt und die in diesem Fall Pro- 
20 jekt.xml heifit. 

Projekt. xml - Diese Datei beinhaltet alle 

Links zu den XML- Dateien, welche die 

Projektdaten genauer spezif izieren, 
Wp zu Beispiel die einzelnen Devi- 

ces des Projektes. 
Ordner: Projekt - Durch diesen Ordner werden 

die projektglobalen Daten gekapselt. 

30 Projekt. xml - Diese „Linkdatei* verweist auf 

die Devices und alle XML- Datei, 

die projektglobale Daten enthalten. 
Alarms. xml - Zum Speichern der Alarmdaten 

eines SIMOTION SCOUT- 
35 Projektes ist diese Datei entstan- 

den . 
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Installation . xml - In dieser Datei sind Kom- 

ponenten von SIMOTION SCOUT 

beschrieben, die beim Zeitpunkt des 
Exports installiert waren. 
Ref erenceTable.xml - Diese Datei enthalt alle Refe- 

renzen und Verweise, die einzelne 
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S7Proj ectData . xml 



10 Ordner: Device 



15 



20 



Teilkomponenten untereinander besit- 
zen. Damit nach dem Import die Funk- 
tionalitat der Objekte wieder vor- 
handen ist, wird diese Datei ausge- 
wertet . 

Die Hardwarekonf iguration der Step7- 
Anteile wird in der 

Datei beschrieben . 

In diesem Ordner sind alle XML- Do- 
kumente, XSL- Files, HTML- 

Seiten und Unterordner enthalten, 
die Einzelheiten eines Device bein- 
halten. Da ein Projekt aus mehren 
Devices aufgebaut sein kann, dass 
mehrere Ordner dieser Art vorhanden 
sind. 

Auch in diesem Ordner wurde eine 
XML- Datei erstellt, die dieses De- 
vice im XML- Format beschreibt. 



Device -xml - Wie oben erklart, verwaltet diese 

Datei Links zu anderen 

untergeordneten XML- Dateien. 
15 RunTimeLevels . xml - In der Datei stehen 

die Tasks, die von dieser Device bearbeitet 

werden konnen. 

DeviceData.xml - Diese Datei beinhaltet die Ei- 

genschaften eines Device. 
30 Device_Symbols .xml - Hier werden die Symbole und Va- 

riablen eines Device gespeichert, 
wie z.B. 10- Variablen. 
Ordner : ProcessingUnit - Dieser Ordner enthalt alle 

Programme, die in die CPU geladen 
35 werden konnen und ausgefuhrt werden 

konnen. 
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ProcessingUnit .xml - Diese Datei enthalt alle Links 

auf die erstellten Programme. 

SCL-Programm. xml - In dieser Datei wird ein Pro- 

gramm (MCC- Programm oder St- 
5 Programm) beschrieben. 

Ordner: TOCamType - Der Ordner enthalt fur die Kur- 

venscheiben spezifische Daten. 

TOCamType . xml - Alle Links auf die im Projekt ent- 

10 haltenen Kurvenscheiben sind in 

dieser Datei enthalten. 
Kurvenscheibe. xml - Hier werden die Daten einer 

Kurvenscheibe gespeichert . 

15 Ordner: TOPosAxis - Dieser Order enthalt alle Daten 

der Positionierungsachsen. Alle 

anderen Objekte, die in einer Stati- 
on enthalten sein konnen, werden in 
einer ahnlichen Hierarchie hinter- 
20 legt, dabei macht eine Kurvenscheibe 

eine Ausnahme. So werden zum Bei- 
spiel alle Messtaster einer Station 
in einem Ordner namens „TOMeasurin- 
glnputType* gespeichert. Dieser Ord- 
ner beinhaltet eine gleichnamige 
XML- Datei die Links zu jeder XML- 
Datei eines einzelnen Messtasters. 
Diese XML- Files tragen den Namen 
des Messtasters und liegen in einem 
30 gleichnamigen Unterordner des „TO- 

MeasuringlnputType* - Ordners. In 
diesem Ordner ist aufierdem die Ex- 
pertenliste des Messtasters im XML- 
Format gespeichert . 



35 



TOPosAxis .xml - Die Datei bein- 

haltet Links zu den einzelnen Positionierungsachsen 



Seite 69 von 56 



200023311 



70 

Ordner : Positionierungsachse - Dieser Ordner entha 

alle Daten einer Positionierungsachse 

Positionierungsachse . xml - Diese „Linkdatei* zeigt 

auf die „Datendatei* der Posi tionierachse . 

ExpertList •xml - Die Expertenliste der Positio 

nierungsachse ist in der Datei 

hinterlegt . 
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Patent anspruche 

1. Verfahren zur Ablage und zur Bearbeitung von Projekt- 
und/oder Pro j ekt ierungsdaten einer Automatisierungskompo- 
nente, 

gekennzeichnet durch eine Untermenge folgender Merkmale: 

Bereitstellung von Projektdaten einer Automatisierungskom- 
ponente auf Basis XML, 

Export/ Import von Projektdaten in XML und 
Verarbeitung der XML-Daten mit Standardwerkzeugen. 

2. Verfahren nach Anspruch 1, 

dadurch gekennzeichnet, dass als Standardwer zeuge eine Unter- 
menge von 

Versionsverwaltungstools 

Externe CAD-Programme 

Externe Kurvenscheibenwerkzeuge 

Externe Productivity Tools 

Externe Skripting Mechanismen 
verwendet wird. 

3. System zur Ablage und zur Bearbeitung von Projekt- 
und/oder Pro j ektierungsdaten einer Automatisierungskompo- 
nente, 

gekennzeichnet durch eine Untermenge folgender Merkmale: 

- Bereitstellung von Projektdaten einer Automatisierungskom- 
ponente auf Basis XML, 

Export/Import von Projektdaten in XML und 
Verarbeitung der XML-Daten mit Standardwerkzeugen. 

4. System nach Anspruch 3, 

dadurch gekennzeichnet, dass als Standardwerzeuge eine Unter- 
menge von 

Versionsverwaltungstools 

- Externe CAD-Programme 
Externe Kurvenscheibenwerkzeuge 

- Externe Productivity Tools 
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Externe Skripting Mechanismen 
verwendet wird. 
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